home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_200 / 206_01 / readme.a < prev   
Encoding:
Text File  |  1980-01-01  |  7.5 KB  |  168 lines
  1.                          CHECK REGISTER PROGRAM
  2.                           CP/M-80 Version 1.0
  3.                              by WoolleyWare
  4.  
  5.  
  6.                               INSTALLATION
  7.  
  8. LBR Distribution Library
  9.  
  10. The Check Register Program simplifies the task of managing one or more
  11. checking accounts.  Because of its size, the program was originally
  12. provided as two separate library files named CHX8010A.LBR and
  13. CHX8010B.LBR.  The filenames were derived from the following:
  14.  
  15.      CHX  Acronym for Check Register Program
  16.      80   CP/M-80 Version
  17.      10   Version 1.0
  18.      A    Executable and Demonstration Files
  19.                -READ-ME.A     This file
  20.                ABSTRACT.DOC   Abstract of document
  21.                CHECKS.COM     Manage current check register
  22.                CLEARS.COM     Mantain/summarize cleared entries
  23.                CHECKSIN.COM   Install CHECKS.SCR
  24.                CHECKSIN.DAT   Installation data
  25.                CHECKS.SCR     Screen control data
  26.                DEMO.DAT       Demonstration check register
  27.                DEMO.INF       Demonstration information
  28.   or B    Documentation and C Language Source Files
  29.                -READ-ME.B     Similar to -READ-ME.A
  30.                CHECKS.DOC     Complete document
  31.                CHECKS.H       \
  32.                CHECKS.C        |
  33.                CHECKA.C        |
  34.                CHECKB.C         >  Source files
  35.                CHECKC.C        |
  36.                CHECKD.C        |
  37.                XIO.C          /
  38.  
  39. You may find it convenient to evaluate the A library first, to determine
  40. whether the program will satisfy your needs.
  41.  
  42. An appropriate public domain (PD) program such as LU, NULU, or LSWEEP
  43. may be used to extract files from each LBR distribution library.  Any
  44. which are squeezed (have a Q as the second letter of the file type, as
  45. in FILENAME.TQP) should be unsqueezed using a PD program like USQ or
  46. NSWEEP.
  47.  
  48. The CHECKS.DOC file should be printed for your use.  Do not use a
  49. formatting print routine such as WordStar's Print function.  CHECKS.DOC
  50. has already been formatted, so that page numbers will be consistent with
  51. the Table of Contents.  It may be conveniently printed using the CP/M
  52. PIP utility.  Place PIP.COM and CHECKS.DOC in drive A.  At the A>
  53. prompt, type
  54.  
  55.      PIP LST:=CHECKS.DOC
  56.  
  57. after first making sure that your printer is set for 66 lines per page
  58. (11 inch page at 6 lines per inch) and 80 columns per line, loaded with
  59. continuous fan-fold paper, and positioned with the print-head at top-of-
  60. page.
  61.  
  62. Once all necessary files have been extracted and unsqueezed, store the
  63. original LBR distribution disk in a safe place as a backup.  That disk
  64. should be used if you wish to make a copy for a friend.
  65.  
  66. CHECKS.SCR File and CHECKSIN Program
  67.  
  68. The Check Register Program utilizes the screen parameter file CHECKS.SCR
  69. to identify cursor controls which are compatible with your video display
  70. terminal or computer console.  A copy of CHECKS.SCR is included in the
  71. distribution library.  Contrary to the documentation, this copy has
  72. already been installed for an Osborne 1/Executive/Vixen computer.
  73.  
  74. If you do not have an Osborne computer, the CHECKSIN program will
  75. automatically adapt CHECKS.SCR to work properly with your equipment.
  76. Place CHECKSIN.COM, CHECKSIN.DAT, and CHECKS.SCR on a single disk in
  77. drive A.  You should leave about 2 KB free space on the disk.  Do not
  78. remove this disk until the installation process is complete.  At the A>
  79. prompt, type
  80.  
  81.      CHECKSIN
  82.  
  83. Additional instructions will be displayed by the program, or read
  84. CHECKS.DOC for further details.
  85.  
  86.  
  87.                          EXECUTING the PROGRAM
  88.  
  89. The Check Register Program requires that CHECKS.SCR reside in the
  90. default disk drive (indicated as part of the > prompt).  When the
  91. program is started, it will look for an information file of type INF and
  92. a database file of type DAT, which need not be on the same disk as the
  93. COM or SCR files.  When the program is stopped using ^KD, it will add
  94. any cleared entries to a file of type CLR, rename the original DAT file
  95. to be of type BAK, and write the current active register to a new DAT
  96. file.  The INF, DAT, CLR, and BAK files will all be on the same disk and
  97. will all have the same filename; the default filename is CHECKS, but you
  98. may choose another name.  In this way, you may manage more than one
  99. check register by giving each a different name.
  100.  
  101. On the command line, you may indicate which check register to use.  For
  102. example, if you wish to work with the demonstration files provided in
  103. the distribution library, place a copy of DEMO.DAT and DEMO.INF in drive
  104. A along with CHECKS.COM and CHECKS.SCR.  At the A> prompt type
  105.  
  106.      CHECKS DEMO
  107.  
  108. Press ^J (CONTROL and J simultaneously) for a brief "help" screen, then
  109. try to find your way around the demonstration.
  110.  
  111. In general, the command line may be typed as
  112.  
  113.      u>v:CHECKS w:filename
  114.  
  115. where u represents the default disk drive containing CHECKS.SCR, v
  116. indicates the drive where CHECKS.COM is located, and the register files
  117. may be found on drive w with the name "filename".  If v: is not
  118. specified, the COM and SCR files will be assumed on default drive u.
  119. Similarly, if w: is not included, register files will be read and
  120. written on the default drive.  Finally, if "filename" is blank, the
  121. default name CHECKS will be assumed.
  122.  
  123. The CLEARS program is initiated in a similar manner.  CHECKS.SCR must be
  124. on the default disk.  CLEARS will read the filename.INF and filename.CLR
  125. files and write a new filename.CLR file; DAT and BAK files are not
  126. involved with the CLEARS program.  The general command line is
  127.  
  128.      u>v:CLEARS w:filename
  129.  
  130. where the default "filename" is CHECKS.
  131.  
  132.  
  133.                             GETTING STARTED
  134.  
  135. The simplest way to begin a new check register is to place CHECKS.COM,
  136. CLEARS.COM, and CHECKS.SCR (installed for your screen) on a disk in
  137. drive A.  At the A> prompt, type
  138.  
  139.      CHECKS
  140.  
  141. The program will indicate that CHECKS.INF and CHECKS.DAT are not
  142. available, but you should choose to continue.  You will then be
  143. presented with an empty register.
  144.  
  145. Find the oldest uncleared entry in your previous paper check register.
  146. Determine the account balance which existed prior to that transaction,
  147. and enter the balance amount into the new register as a deposit (DEP).
  148. Call that entry something like "Current Balance", and mark it cleared
  149. (CLR).  Then proceed to transfer all remaining transactions from your
  150. previous register to your new register, marking them CLR if appropriate.
  151. When completed, you may wish to order (^KO) and/or print (^KP) the
  152. result.  Finally, use ^KD to quit the program.
  153.  
  154. You should observe that CHECKS.DAT and CHECKS.CLR have been added to
  155. drive B.  You may wish to investigate these files by restarting CHECKS
  156. or by executing CLEARS (in the same manner as CHECKS).
  157.  
  158. You may wish to create a companion information file with the default
  159. name CHECKS.INF.  Use a familiar ASCII text editor such as ED or
  160. WordStar (Non-document mode) as described in CHECKS.DOC.  Define any
  161. automatic transactions, which might include salary deposits, mortgage
  162. payments, or checking account fees.  Add abreviations for utility
  163. companies, loan companies, credit cards, supermarkets, etc.  Then
  164. compose a title for your personalized register.
  165.  
  166. Read the document for detailed information about the Check Register
  167. Program.
  168.